Technical Q&As

QTW 78 - Customizing the QTW Installer (3-July-96)


Q I heard at WWDC that the QTW installer can be customized through a '.ini' file. Where can I get information about this?


AThe following is the format for the optional configuration file that can be used with QTINSTAL.EXE. If used, it must be named QTINSTAL.INI, and it must be located in the same directory as QTINSTAL.EXE. For all of the options listed except DialogStyle, a value of 1 enables the option, a value of zero disables it.

Although all combinations are designed to work (i.e., the program will run correctly), not all combinations of options will yield a viable result. For example, creating a program group without unpacking the files would probably not be a good idea.

       ; All QTW installer options must be in the following section:
	[Options]
	 	; The QuickTime background can be suppressed when QTINSTAL is to be called
	; from another program:
	;   1 - shows a background window with QuickTime banner.
	;   0 - shows no background window.
	StandAlone=1
	 	; A Dialog style may be specified by one of the following values:
	;   1 - Thin frame
	;   2 - System menu
	;   3 - Thin frame and system menu (default)
	DialogStyle=3
	 	; If the following option is set, the client area of all dialogs will
	; have  a 3-D look.
	Ctl3D=1
	 	; If the following option is set, the installer will display the QTW
	; end-user license agreement, with Agree/Disagree buttons.
	DisplayLicenseAgreement=1
	 	; If the following option is set, an opening dialog will prompt the user
	; whether to begin the installation or to exit.
	PromptToBegin=1
	 	; If the following option is set, existing-version checking will be enabled
	; and the installer will evaluate the PromptToDeleteVersions option.  If
	; CheckExistingVersions is set to zero, the installer will not check for
	; existing versions.
	CheckExistingVersions=1
	 	; If CheckExistingVersions and the following option are set, the installer
	; will prompt the user before doing a search operation for all out-of-date
	; QTW installations on the machine.  For each installation found, a dialog
	; will ask the user whether to mark it for deletion.  If this option is
	; set to zero, the search will be unconditional and all installations found
	; will be marked for deletion.
	PromptToDeleteVersions=1
	 	; If the following option is set, a "do you want to continue" dialog will
	; appear before any files are deleted or the hard disk is modified in any
	; way.
	PromptToComplete=1
	 	; If the following option is set, all files will be unpacked from the 
	; executable and written to disk.  Care and consideration should be used
	; before setting this option to zero, since a zero value means no files
	; will be installed.
	UnpackFiles=1
	 	; If the following option is set, the Windows INI files will be updated.
	UpdateIniFiles=1
	 	; If the following option is set, Program Manager groups will be created.
	CreateGroups=1
	 	; If CreateGroups is set and the following option is used, the specified
	; name will be used as the group name (that is, the name as it displays
	; in the window titlebar, not the group filename) that the installer will
	; use when installing the QuickTime icons.  For example, the option shown
	; would use the group name "My Group."  If the group does not exist it
	; will be created.  This option can be used to add the QuickTime
	; applications to an existing group file.  The string used to specify a
	; group name should be tested in actual use, since there is a practical
	; upper limit to the number of characters Windows will use in a window
	; title.
	GroupName=My Group
	 	; If the following option is set, a success dialog will indicate whether
	; the installation has completed successfully.
	SuccessDialog=1
	 	; If SuccessDialog and the following option are both set, the installer
	; will launch Movie Player with a sample movie to verify that QTW has
	; been installed successfully.
	PlaySampleMovie=1
	 

The Installer also always creates a file in the Windows directory called RESULT.QTW that looks like this:

       [QTW Install 16]
	Complete=1
	 	[QTW Install 32]
	Complete=1
	 

If Complete=0, the installation didn't finish for some reason (any reason, such as the user cancelling, or running out of disk space, or whatever). This is so that the title installer can tell whether the QTW install was successful, and respond appropriately.

 



Technical Q&As
Previous Question | Contents | Next Question